home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Util / A-Ag / Add⁄Strip2.8.cpt / Add_Strip 2.8 Docs next >
Encoding:
Text File  |  1989-09-10  |  8.9 KB  |  233 lines
  1. Add/Strip (version 2.8) Docs - Add/Strip 2.8 © 1987-89 Jon Wind
  2.                              - This file MUST accompany Add/Strip 2.8
  3.                              - This application is Shareware ($25)
  4.                              - Source code is available ($35)
  5.                              - Please do not distribute modified copies
  6.  
  7. Files Included:
  8.  
  9. 1.  Add/Strip 2.8 Docs - This file. - Written using 9 point Monaco.
  10.  
  11. 2.  Add/Strip 2.8 - The application.
  12.  
  13. 3.  Edit Add/Strip 2.8 - An application to edit Add/Strip 2.8.
  14.  
  15.  
  16.  
  17. Brief History:
  18. ----------------
  19.  
  20. Add/Strip (A/S) was originally written to facilitate our desktop publishing
  21. area’s productivity.  They use Aldus PageMaker and Quark XPress (recommended)
  22. to produce many of our company’s publications.  The copy is written on Wangs,
  23. CPTs, and DOS-based machines.  These text files are then sent to the Macs for
  24. page layout.  Unfortunately, these files are seldom formatted properly for
  25. their needs.
  26.  
  27. A/S has been designed to automatically perform much of the work of cleaning up
  28. TEXT files destined for import to page layout, word processing, database, or
  29. spreadsheet programs, as well as export from these programs to a DOS-based or
  30. mainframe computer, in a fraction of the time ordinarily needed to manually
  31. reformat using a word processor.
  32.  
  33. Version 2.8 of A/S is the product of many hours of work, and is available as
  34. Shareware.  If you use it, please pay for it.  See the section entitled
  35. “Registration” for more.
  36.  
  37.  
  38.  
  39. Commands:
  40. -----------
  41.  
  42. -->  See the online help for a complete description of current functions and
  43. limitations.
  44.  
  45. -->  Please note that “Strip CRs” is NOT the same as “Make Paragraphs.”  Use
  46. “Make Paragraphs” or “Make Paragraphs2” if you plan on importing the text
  47. file to a page layout or word processing program.
  48.  
  49. -->  Depending on which main function is currently selected, certain options
  50. may be disabled or defaulted.  The following table should help explain:
  51.  
  52.  
  53. Main Function             |Strip LFs |Lead Str |Trail Spc |Unhyph | 255 Limit
  54. --------------------------+----------+---------+----------+-------+----------
  55. Read & Write File         |No        |Option   |Option    |No     | No
  56. Make Paragraphs           |Yes       |Option   |Option    |Yes    | No
  57. Make Paragraphs2          |Yes       |Option   |Option    |Yes    | No
  58. WordStar™ -> Text         |Yes       |Option   |Option    |No     | No
  59. Add Characters            |No        |Option   |Option    |No     | No
  60. Strip Characters          |Option    |Option   |Option    |No     | No
  61. Force Line Width          |Yes       |Strip    |Strip     |No     | No
  62. Space Runs -> Tab         |No        |Option   |Option    |No     | No
  63. Tabs -> Space Runs        |No        |Option   |Option    |No     | No
  64. CSV -> Tab Delimited      |No        |Option   |Option    |No     | Yes
  65. Tab Delimited -> CSV      |No        |Option   |Option    |No     | Yes
  66. Tab Delimited -> Fixed    |No        |Option   |Option    |No     | Yes
  67. Tab Delimited -> Variable |No        |Option   |Option    |No     | Yes
  68. Variable -> Tab Delimited |No        |Option   |Option    |No     | Yes
  69. --------------------------+----------+---------+----------+-------+----------
  70.  
  71.  
  72.  
  73. Order of Processing:
  74. ----------------------
  75.  
  76. Read line
  77. Replacement set #1-9
  78. Filter noise characters
  79. Make ellipses
  80. Make em dashes
  81. Make ligatures
  82. Leading String (performed in main process when making paragraphs)
  83. Strip trailing spaces (performed in main process when making paragraphs)
  84. Quotes & Apostrophes
  85. Normalize spaces
  86. Adjust Case
  87. Perform Main Process
  88. Write line
  89.  
  90.  
  91.  
  92. New in 2.8:
  93. --------------
  94.  
  95. 1.  Improved MultiFinder friendliness; it demands less attention from
  96.     MultiFinder when running in the background.
  97.  
  98. 2.  Changed Edit Add/Strip so that functions are accessed via menus rather
  99.     than a modal window, allowing it to better coexist with MultiFinder.
  100.     Also improved error checking.
  101.  
  102. 3.  Fixed right justify numbers bug in “Tab Delimited -> Fixed” process.
  103.  
  104. 4.  Added “Tab Delimited -> CSV” process.
  105.  
  106. 5.  Added “Insert” item to the “Leading String” popup menu.
  107.  
  108. 6.  Altered “Set TEXT File Creator” window to use a popup menu to select a
  109.     new Creator and added a key equivalent to its menu item.
  110.  
  111. 7.  Changed file select windows so that the “Open” button will read “Open”
  112.     when a folder is highlighted or, when a file is selected, it will reflect
  113.     the action to be taken, such as “Process”, “Browse”, or “Transfer.”
  114.  
  115. 8.  Resolved conflicts that some people were having with processing folders
  116.     not working when certain INITs were loaded.
  117.  
  118. 9.  Changes made to the current settings in the “Process Select” window will
  119.     no longer be saved if the Cancel button is chosen.
  120.  
  121. 10. Added preferences options to enable/disable line wrapping when browsing
  122.     a file and quote counting.
  123.  
  124. 11. Added ability to select or deselect all “Process Select” window toggle
  125.     and “Replacement Strings” window activate set checkboxes by shift-clicking
  126.     on a checkbox item.  Also made pressing command-n (where n is 1-9) the
  127.     same as clicking on the corresponding activate set checkbox, while
  128.     command-0 deselects all sets in the “Replacement Strings” window.
  129.  
  130. 12. Improved “Add Characters” process to better handle lines longer than 220
  131.     characters.
  132.  
  133. 13. Reorganized source code to allow future versions to be compiled using
  134.     Think Pascal.  Sorry about that Borland...
  135.  
  136. 14. Added order of processing list to online help.
  137.  
  138. 15. Wrote 30 pages of documentation and increased price.
  139.  
  140.  
  141.  
  142. Operating Tips:
  143. -----------------
  144.  
  145. 1.  Read the online help CAREFULLY.
  146.  
  147. 2.  Don’t trash the original TEXT file until AFTER verifying that A/S has done
  148.     what was expected.  The “Browse TEXT File…” option may be used to do this,
  149.     though 10-25K can be displayed.
  150.  
  151. 3.  Be certain to verify ALL settings, including replacement strings, before
  152.     OKing to be sure that the correct processing will be done.
  153.  
  154. 4.  Change the Output File Creator to launch a program other than A/S when the
  155.     new TEXT file is opened.  For instance, changing it to “MACA” provides
  156.     launching into MacWrite.  Be sure that the file whose File Creator is used
  157.     accepts TEXT files.
  158.  
  159. 5.  Lines of text on a Mac are generally terminated with a CR, while DOS-based
  160.     machines use a CRLF sequence.  Therefore, if a Macintosh TEXT file is to
  161.     be transferred to an DOS-based machine, it would be appropriate to select
  162.     the “Add LFs to paragraphs” checkbox when it’s available, or the “LFs”
  163.     checkbox when “Add characters” is chosen. “Uncurl” quotes and apostrophes
  164.     should also be chosen.
  165.  
  166. 6.  Consider processing a file 2 or more times to achieve the desired effect.
  167.  
  168. 7.  If CRs are part of your replacement set, consider using something like my
  169.     (soon to be updated) Reponer program, which supports search and replace
  170.     on any characters, in conjunction with A/S.
  171.  
  172. 8.  Because replacements are made blindly, use a word processor to do
  173.     conditional character replacement instead of A/S.
  174.  
  175. 9.  If you plan on processing more than one file using EXACTLY the same
  176.     settings, hold down the Shift key when selecting the “OK” button in the
  177.     “Process Select” window.
  178.  
  179. 10. Holding down the option key when selecting the “OK” button in the “Process
  180.     Select” window and when selecting the “Browse TEXT File…” menu item to
  181.     display all files for opening.
  182.  
  183. 11. Make the most commonly used settings the default values by choosing “Save
  184.     settings as Default,” and/or save them as separate files.  Opening a
  185.     settings file will launch A/S, loading the values contained in that file.
  186.  
  187. 12. Notify the author if you find a bug, or it may not get fixed.
  188.  
  189.  
  190.  
  191. Registration:
  192. ---------------
  193.  
  194. Add/Strip is Shareware.  This means that if you use it, you should pay for it.
  195. It’s as simple as that.  I believe this a useful program.  I hope you feel the
  196. same.  Please don’t rip me off.
  197.  
  198. Registered users receive a disk with the latest version, printed documentation,
  199. and may use future versions at no additional cost.  Registration is $25.  Site
  200. licenses, which allow for an unlimited number of copies to be used at a single
  201. location, are available for $100.  Users who’ve already sent money and BBS
  202. operators may use this version free of charge.
  203.  
  204. Commented source code for both Add/Strip and Edit Add/Strip (approx. 180K of
  205. Turbo Pascal) is available for $35, which includes registration.
  206.  
  207. If you choose not to send money, AT LEAST send comments, suggestions, and/or
  208. bug reports.  I can be reached at:
  209.  
  210. Jon Wind (A/S 2.8)   <-- let me know which version you’re using
  211. 2374 Hillwood Drive
  212. Maplewood, MN  55119
  213.  
  214. or  COMPUSERVE: 70167,3444  or  GENIE: JPWIND  or  MCIMAIL: J.WIND
  215.  
  216.  
  217.  
  218. Acknowledgments:
  219. -------------------
  220.  
  221. Thanks are extended to those individuals who’ve bothered to send money and
  222. (no less importantly) to those who’ve offered suggestions for improvements,
  223. especially Charles Vass and John Ware.
  224.  
  225.  
  226.  
  227. Mandatory Disclaimer:
  228. -----------------------
  229.  
  230. A/S SHOULD work on Mac Pluses or above.  It works fine on the Macs I’ve
  231. tested it on, but I cannot guarantee that it will on yours.  Still, if it
  232. doesn’t, please let me know and I’ll see what I can do.
  233.